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10 Application No. 60/199,046, entitled "Software Development Tool," filed on April 21, 
2000; all of which are incorporated herein by reference. 

The following identified U.S. patent applications are also relied upon and are 
incorporated by reference in this application: 
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15 Displaying Changes Of Source Code," filed on October 4, 2000; 
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U.S. Patent Application No. 09/680,064, entitled "Method And System For 
Collapsing A Graphical Representation Of Related Elements," filed on October 4, 2000; 

20 U.S. Patent Application No. , entitled "Methods and Systems for 

Relating Data Structures and Object Oriented Elements for Distributed Computing," bearing 
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U.S. Patent Application No. , entitled "Methods and Systems for 

Finding Specific Line Of Source Code," bearing attorney docket no. 30013630-0011, and 
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U.S. Patent Application No. , entitled "Methods and Systems for 

Finding and Displaying Linked Objects," bearing attorney docket no. 30013630-0012, and 
filed on the same date herewith; 
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U.S. Patent Application No. , entitled "Methods and Systems for 

Animating the Interaction of Objects in an Object Oriented Program," bearing attorney 
docket no. 30013630-0013, and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Methods and Systems for 

5 Supporting and Deploying Distributed Computing Components," bearing attorney docket 
no. 30013630-0014, and filed on the same date herewith; 

U.S. Patent Application No. , entitled "Diagrammatic Control of a 

Software in a Version Control System," bearing attorney docket no. 30013630-0015, and 
filed on the same date herewith; 

10 U.S. Patent Application No. , entitled "Navigation Links in 

Generated Documentation," bearing attorney docket no. 30013630-0016, and filed on the 
same date herewith; 

U.S. Patent Application No. , entitled "Methods and Systems for 

Identifying Dependencies Between Object-Oriented Elements," bearing attorney docket no. 
15 3 00 1 3 63 0-00 1 9, and filed on the same date herewith; and 

U.S. Patent Application No. , entitled "Methods and Systems for 

Relating a Data Definition File and a Data Model for Distributed Computing," bearing 
attorney docket no. 30013630-0020, and filed on the same date herewith. 

Field Of The Invention 

20 The present invention relates to a method and system for developing software. More 

particularly, the invention relates to a method and system for generating source code in an 
object-oriented element to reflect an added link to another object-oriented element. 

Background Of The Invention 

Computer instructions are written in source code. Although a skilled programmer 
25 can understand source code to determine what the code is designed to accomplish, with 
highly complex software systems, a graphical representation or model of the source code is 
helpful to organize and visualize the structure and components of the system. Using models, 
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the complex systems are easily identified, and the structural and behavioral patterns can be 
visualized and documented. 

The well-known Unified Modeling Language (UML) is a general-purpose notational 
language for visualizing, specifying, constructing, and documenting complex software 
5 systems. UML is used to model systems ranging from business information systems to 
Web-based distributed systems, to real-time embedded systems. UML formalizes the notion 
that real-world objects are best modeled as self-contained entities that contain both data and 
functionality. UML is more clearly described in the following references, which are 
incorporated herein by reference: (1) Martin Fowler, UML Distilled Second Edition: 

10 Applying the Standard Object Modeling Language . Addison-Wesley (1999); (2) Booch, 
Rumbaugh, and Jacobson, The Unified Modeling Language User Guide , Addison-Wesley 
(1998); (3) Peter Coad, JefFDeLuca, and Eric Lefebvre, Java Modeling in Color with UML: 
Enterprise Components and Process . Prentice Hall (1999); and (4) Peter Coad, Mark 
Mayfield, and Jonathan Kern, Java Design: Building Better Apps & Applets (2nd Ed.), 

15 Prentice Hall (1998). 

As shown in Fig. 1, conventional software development tools 100 allow a 
programmer to view UML 102 while viewing source code 104. The source code 104 is 
stored in a file, and a reverse engineering module 106 converts the source code 104 into a 
representation of the software project in a database or repository 108. The software project 

20 comprises source code 104 in at least one file which, when compiled, forms a sequence of 
instructions to be run by the data processing system. The repository 108 generates the UML 
102. If any changes are made to the UML 102, they are automatically reflected in the 
repository 108, and a code generator 110 converts the representation in the repository 108 
into source code 104. Such software development tools 100, however, do not synchronize 

25 the displays of the UML 102 and the source code 104. Rather, the repository 108 stores the 
representation of the software project while the file stores the source code 104. A 
modification in the UML 102 does not appear in the source code 104 unless the code 
generator 1 10 re-generates the source code 104 from the data in the repository 108. When 
this occurs, the portion of the source code 104 that is not protected from being overwritten is 

30 rewritten. Similarly, any modifications made to the source code 104 do not appear in the 



UML 102 unless the reverse engineering module 106 updates the repository 108. As a 
result, redundant information is stored in the repository 108 and the source code 104. In 
addition, rather than making incremental changes to the source code 104, conventional 
software development tools 100 rewrite the overall source code 104 when modifications are 
5 made to the UML 102, resulting in wasted processing time. This type of manual, large- 
grained synchronization requires either human intervention, or a "batch" style process to try 
to keep the two views (the UML 102 and the source code 104) in sync. Unfortunately, this 
approach, adopted by many tools, leads to many undesirable side-effects; such as desired 
changes to the source code being overwritten by the tool. A further disadvantage with 
10 conventional software development tools 100 is that they are designed to only work in a 
single programming language. Thus, a tool 100 that is designed for Java™ programs cannot 
be utilized to develop a program in C++. There is a need in the art for a tool that avoids the 
limitations of these conventional software development tools. 

Summary Of The Invention 

15 Methods and systems consistent with the present invention provide an improved 

software development tool that overcomes the limitations of conventional software 
development tools. The improved software development tool of the present invention 
allows a developer to simultaneously view a graphical and a textual display of source code. 
The graphical and textual views are synchronized so that a modification in one view is 

20 automatically reflected in the other view. In addition, the software development tool is 
designed for use with more than one programming language. 

The software development tool also saves a developer time and effort in producing 
error free code. The software development tool enables the developer to graphically 
designate a desired link between a source and a destination element in a software project and 

25 then automatically adds source code in the respective element to reflect the link. The link 
can be a generalization link that identifies an inheritance relationship, resulting in the source 
element (the source of the link) inheriting all the attributes and methods of the destination 
element (the destination of the link). The link can also be an implementation link that 
identifies a specification relationship, resulting in the source of the link implementing all the 
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methods contained in an interface, the destination of the link. To ensure error free coding, 
the software development tool determines whether the desired link adheres to object- 
oriented programming rules. In addition, the software development tool saves a developer 
time and effort in correcting the source code. The software development tool allows the 
5 developer to selectively replace the source element or the destination element in an existing 
link with another element to produce a new link. In the process of generating the new link, 
the software development tool determines whether the new link is permissible before 
automatically changing the source code of the respective elements to reflect the new link 
and the removal of the existing link. To further aid a programmer in developing source code 

10 for a project, the software development tool allows a developer to graphically designate that 
source code associated with a source element be nested within the source code of a 
destination element in the project. Where a source element is already nested within a 
destination element, the software development tool allows the developer to graphically 
designate that the first be removed from the destination element. Thus, a developer can 

15 efficiently manage and organize software in a project and more easily allow other 
programmers to access or use the source code associated with the nested elements. 
Conversely, a developer can effectively remove nested source code when it is determined no 
longer to be a desirable design. 

In accordance with methods consistent with the present invention, a method is 

20 provided in a data processing system. The data processing system has a plurality of 
elements, and each element has corresponding code. The method comprising the steps of 
receiving a request to form a link, receiving an indication of a first of the plurality of 
elements, receiving an indication of a second of the plurality of elements, and in response to 
receiving the request, the indication of the first element, and the indication of the second 

25 element, adding new code to the first element to reflect the link to the second element. 

In accordance with methods consistent with the present invention, a method is 
provided in a data processing system. The data processing system has a plurality of 
elements with a link between two of the plurality of elements. Each element has 
corresponding code, and the linked elements include a source and a destination. The method 

30 comprising the steps of receiving a selection of one of the linked elements, receiving an 
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identification of another of the plurality of elements that is different than the linked 
elements, determining whether the selected element is the destination, and when it is 
determined that the selected element is the destination, modifying the corresponding code of 
the other element to reflect a new link between the other element and the destination 
5 element. 

In accordance with methods consistent with the present invention, a method is 
provided in a data processing system. The data processing system has a plurality of 
elements with a link between two of the plurality of elements. Each element has 
corresponding code, and the linked elements include a source and a destination. The method 

10 comprising the steps of receiving an identification of the link, receiving a selection of one of 
the linked elements, receiving an identification of another of the plurality of elements that is 
different than the linked elements, determining whether the selected element is the source, 
and when it is determined that the selected element is the source, modifying the 
corresponding code of the source to reflect a new link between the source and the other 

15 element. 

In accordance with methods consistent with the present invention, a method is 
provided in a data processing system. The data processing system has a plurality of 
elements. The method comprising the steps of receiving an identification of a first of the 
plurality of elements, receiving an identification of a second of the plurality of elements, 
20 receiving an indication that the first element is to be included in the second element, 
determining whether the first element is a class and whether the second element is another 
class, and when it is determined that the first element is the class and that the second 
element is the other class, transferring code corresponding to the first element into the 
second element. 

25 In accordance with methods consistent with the present invention, a method is 

provided in a data processing system. The data processing system has a plurality of 
elements. Each element has corresponding code. The code corresponding to a first of the 
plurality of elements is nested in the code corresponding to a second of the plurality of 
elements. The method comprising the steps of receiving an indication that the first element 

30 is to be removed from the second element, determining whether the first element is a class 
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and whether the second element is another class, and when it is determined that the first 
element is the class and that the second element is the other class, removing code 
corresponding to the first element from the second element. 

In accordance with articles of manufacture consistent with the present invention, a 
5 computer-readable medium is provided. The computer-readable medium contains 
instructions for controlling a data processing system to perform a method. The data 
processing system has a plurality of elements, and each element has corresponding code. 
The method comprising the steps of receiving a request to form a link, receiving an 
indication of a first of the plurality of elements, receiving an indication of a second of the 

10 plurality of elements, and in response to receiving the request, the indication of the first 
element, and the indication of the second element, adding new code to the first element to 
reflect the link to the second element. 

In accordance with articles of manufacture consistent with the present invention, a 
computer-readable medium is provided. The computer-readable medium contains 

15 instructions for controlling a data processing system to perform a method. The data 
processing system has a plurality of elements with a link between two of the plurality of 
elements. Each element has corresponding code, and the linked elements include a source 
and a destination. The method comprising the steps of receiving a selection of one of the 
linked elements, receiving an identification of another of the plurality of elements that is 

20 different than the linked elements, determining whether the selected element is the 
destination, and when it is determined that the selected element is the destination, modifying 
the corresponding code of the other element to reflect a new link between the other element 
and the destination element. 

In accordance with articles of manufacture consistent with the present invention, a 

25 computer-readable medium is provided. The computer-readable medium contains 
instructions for controlling a data processing system to perform a method. The data 
processing system has a plurality of elements with a link between two of the plurality of 
elements. Each element has corresponding code, and the linked elements include a source 
and a destination. The method comprising the steps of receiving an identification of the 

30 link, receiving a selection of one of the linked elements, receiving an identification of 



-7- 



another of the plurality of elements that is different than the linked elements, determining 
whether the selected element is the source, and when it is determined that the selected 
element is the source, modifying the corresponding code of the source to reflect a new link 
between the source and the other element. 
5 In accordance with articles of manufacture consistent with the present invention, a 

computer-readable medium is provided. The computer-readable medium contains 
instructions for controlling a data processing system to perform a method. The data 
processing system has a plurality of elements. The method comprising the steps of receiving 
an identification of a first of the plurality of elements, receiving an identification of a second 
1 0 of the plurality of elements, receiving an indication that the first element is to be included in 
the second element, determining whether the first element is a class and whether the second 
element is another class, and when it is determined that the first element is the class and that 
the second element is the other class, transferring code corresponding to the first element 
into the second element. 

15 In accordance with articles of manufacture consistent with the present invention, a 

computer-readable medium is provided. The computer-readable medium contains 
instructions for controlling a data processing system to perform a method. The data 
processing system has a plurality of elements. Each element has corresponding code. The 
code corresponding to a first of the plurality of elements is nested in the code corresponding 

20 to a second of the plurality of elements. The method comprising the steps of receiving an 
indication that the first element is to be removed from the second element, determining 
whether the first element is a class and whether the second element is another class, and 
when it is determined that the first element is the class and that the second element is the 
other class, removing code corresponding to the first element from the second element. 

25 Other systems, methods, features and advantages of the invention will be or will 

become apparent to one with skill in the art upon examination of the following figures and 
detailed description. It is intended that all such additional systems, methods, features and 
advantages be included within this description, be within the scope of the invention, and be 
protected by the accompanying claims. 



Brief Description Of The Drawings 

The accompanying drawings, which are incorporated in and constitute a part of this 
specification, illustrate an implementation of the invention and, together with the 
description, serve to explain the advantages and principles of the invention. In the drawings, 
5 Fig. 1 depicts a conventional software development tool; 

Fig. 2 depicts an overview of a software development tool in accordance with 
methods and systems consistent with the present invention; 

Fig. 3 depicts a data structure of the language-neutral representation created by the 
software development tool of Fig. 2; 
10 Fig. 4 depicts representative source code; 

Fig. 5 depicts the data structure of the language-neutral representation of the source 
code of Fig. 4; 

Fig. 6 depicts a data processing system suitable for practicing the present invention; 

Fig. 7 depicts an architectural overview of the software development tool of Fig. 2; 
15 Fig. 8 A depicts a user interface displayed by the software development tool depicted 

in Fig. 2, where the user interface displays a list of predefined criteria which the software 
development tool checks in the source code; 

Fig. 8B depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays the definition of the criteria which the software 
20 development tool checks in the source code, and an example of source code which does not 
conform to the criteria; 

Fig. 8C depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays an example of source code which conforms to the 
criteria which the software development tool checks in the source code; 
25 Fig. 9 depicts a flow diagram of the steps performed by the software development 

tool depicted in Fig. 2; 

Figs. 10A and 10B depict a flow diagram illustrating the update model step of Fig. 9; 

Fig. 1 1 depicts a flow diagram of the steps performed by the software development 
tool in Fig. 2 when creating a class; 
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Fig. 12 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays a use case diagram of source code; 

Fig. 13 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays both a class diagram and a textual view of source 
5 code; 

Fig. 14 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays a sequence diagram of source code; 

Fig. 15 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays a collaboration diagram of source code; 
10 Fig. 16 depicts a user interface displayed by the software development tool depicted 

in Fig. 2, where the user interface displays a state chart diagram of source code; 

Fig. 17 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays an activity diagram of source code; 

Fig. 18 depicts a user interface displayed by the software development tool depicted 
1 5 in Fig. 2, where the user interface displays a component diagram of source code; 

Fig. 19 depicts a user interface displayed by the software development tool depicted 
in Fig. 2, where the user interface displays a deployment diagram of source code; 

Fig. 20 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2 for initiating the generation of a link between a source element and a 
20 destination element; 

Fig. 21 depicts a flow diagram illustrating an exemplary process performed by the 
software development tool in Fig. 2 to add a link in source code of a source element, when it 
is determined that the source element is capable of being linked to a destination element; 

Fig. 22 depicts an exemplary user interface displayed by the software development 
25 tool depicted in Fig. 2, where the user interface displays a package as the source element 
selected and a class as the destination element selected; 

Fig. 23 depicts an exemplary user interface showing a link error generated by the 
software development tool depicted in Fig. 2 in response to a determination that the source 
element cannot be linked to the destination element; 
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Fig. 24 depicts an exemplary user interface showing new code added by the software 
development tool in Fig. 2 to the source code associated with the source element in response 
to a determination that the source element can be linked to the destination element; 

Fig. 25 depicts a flow diagram of the process performed by the software 
5 development tool in Fig. 2 for determining whether the source element can have a link to the 
destination element; 

Fig. 26 depicts an exemplary user interface showing new code added by the software 
development tool in Fig. 2 to the source code associated with the source element in response 
to a determination that the source element is an interface that can be linked to the destination 
1 0 element that is another interface; 

Fig. 27 depicts an exemplary user interface showing new code added by the software 
development tool in Fig. 2 to the source code associated with the source element in response 
to a determination that the source element is a class that can be linked to the destination 
element that is another class; 
1 5 Fig. 28 depicts an exemplary user interface showing new code added by the software 

development tool in Fig. 2 to the source code associated with the source element in response 
to a determination that the source element is a class that can be linked to the destination 
element that is an interface; 

Fig. 29 depicts a flow chart illustrating an exemplary process performed by the 
20 software development tool in Fig. 2 to replace one of a source or a destination element in an 
existing link with another element to form a new link; 

Fig. 30 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface shows an existing link that has been selected 
by a user to be replaced; 

25 Fig. 3 1 depicts an exemplary user interface displayed by the software development 

tool in Fig. 2, where the user interface shows an identification of another element to link to 
one element in the existing link; 

Fig. 32 depicts an exemplary user interface showing a link error generated by the 
software development tool depicted in Fig. 2 in response to a determination that the other 

3 0 element cannot be linked to the destination element; 
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Fig. 33 depicts an exemplary user interface showing new code added by the software 
development tool in Fig. 2 to the source code associated with the other element to reflect the 
new link with the destination element; 

Fig. 34 depicts an exemplary user interface displayed by the software development 
5 tool depicted in Fig. 2, where the user interface displays an identification that the one 
element to keep from an existing link is the source element, and displays an identification of 
the other element for the new link with the source element; 

Fig. 35 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays a graphical representation of the 
10 source code of the source element, a class, to reflect the new link to the other element, 
another class; 

Fig. 36 depicts a flow diagram of the process performed by the software 
development tool in Fig. 2 for determining whether the other element can have a link to the 
destination element; 

15 Fig. 37 depicts an exemplary user interface displayed by the software development 

tool depicted in Fig. 2, where the user interface displays the destination element, an 
interface, in the existing link as the one element to keep to form a new link with the selected 
other element, another interface; 

Fig. 3 8 depicts an exemplary user interface displayed by the software development 

20 tool depicted in Fig. 2, where the user interface displays a graphical representation of the 
source code of the other element, an interface, to reflect the new link to the destination 
element, another interface; 

Fig. 39 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays an identification that the one 

25 element to keep from an existing link is the destination element, and displays an 
identification of the other element for the new link with the destination element; 

Fig. 40 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays a graphical representation of the 
source code of the other element, a class, to reflect the new link to the destination element, 

30 another class; 
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Fig. 41 depicts a flow diagram of the steps performed by the software development 
tool in Fig. 2 for determining whether the source element can have a link to the other 
element; 

Fig. 42 depicts an exemplary user interface displayed by the software development 
5 tool depicted in Fig. 2, where the user interface displays an identification that the one 
element to keep from an existing link is the source element, and displays an identification of 
the other element for the new link with the source element; 

Fig. 43 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays a graphical representation of the 
10 source code of the source element, an interface, to reflect the new link to the other element, 
another interface; 

Fig. 44 depicts a flow chart of the process performed by the software development 
tool in Fig. 2 for moving source code associated with a source element into source code of a 
destination element; 

15 Fig. 45 depicts an exemplary user interface displayed by the software development 

tool depicted in Fig. 2, where the user interface displays an identification of the source 
element and an identification of the destination element; 

Fig. 46 depicts an exemplary user interface displayed by the software development 
tool in Fig. 2 after moving the source code corresponding to the source element within the 
20 source code corresponding to the destination element; 

Fig. 47 depicts an exemplary user interface displayed by the software development 
tool in Fig. 2 after moving a first file associated with the source element within the directory 
associated with the destination element that is a package; 

Fig. 48 depicts an exemplary user interface displayed by the software development 
25 tool in Fig. 2 after moving a first directory associated with a source element within the 
second directory associated with the destination element when it is determined that both 
elements are packages; 

Fig. 49 depicts a flow of the process performed by the software development tool in 
Fig. 2 for removing source code associated with a source element from within source code 
30 of a destination element; 
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Fig. 50 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays an identification of the source 
element and an identification of the destination element; 

Fig. 51 depicts an exemplary user interface displayed by the software development 
5 tool in Fig. 2 after removing the source code corresponding to the source element from 
within the source code corresponding to the destination element; 

Fig. 52 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays an identification of the source 
element and an identification of the destination element; 
10 Fig. 53 depicts an exemplary user interface displayed by the software development 

tool in Fig. 2 after removing a first file associated with the source element from within the 
directory associated with the destination element that is a package; 

Fig. 54 depicts an exemplary user interface displayed by the software development 
tool depicted in Fig. 2, where the user interface displays an identification of the source 
1 5 element and an identification of the destination element; and 

Fig. 55 depicts an exemplary user interface displayed by the software development 
tool in Fig. 2 after removing a first directory associated with a source element within the 
second directory associated with the destination element when it is determined that both 
elements are packages. 

20 Detailed Description Of The Invention 

Methods and systems consistent with the present invention provide an improved 
software development tool that creates a graphical representation of source code regardless 
of the programming language in which the code is written. In addition, the software 
development tool simultaneously reflects any modifications to the source code to both the 

25 display of the graphical representation as well as the textual display of the source code. 

As depicted in Fig. 2, source code 202 is being displayed in both a graphical form 
204 and a textual form 206. In accordance with methods and systems consistent with the 
present invention, the improved software development tool generates a transient meta model 
(TMM) 200 which stores a language-neutral representation of the source code 202. The 
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graphical 204 and textual 206 representations of the source code 202 are generated from the 
language-neutral representation in the TMM 200. Alternatively, the textual view 206 of the 
source code may be obtained directly from the source code file. Although modifications 
made on the displays 204 and 206 may appear to modify the displays 204 and 206, in 
5 actuality all modifications are made directly to the source code 202 via an incremental code 
editor (ICE) 208, and the TMM 200 is used to generate the modifications in both the 
graphical 204 and the textual 206 views from the modifications to the source code 202. 

The improved software development tool provides simultaneous round-trip 
engineering, i.e., the graphical representation 204 is synchronized with the textual 

10 representation 206. Thus, if a change is made to the source code 202 via the graphical 
representation 204, the textual representation 206 is updated automatically. Similarly, if a 
change is made to the source code 202 via the textual representation 206, the graphical 
representation 204 is updated to remain synchronized. There is no repository, no batch code 
generation, and no risk of losing code. 

15 The data structure 300 of the language-neutral representation is depicted in Fig. 3. 

The data structure 300 comprises a Source Code Interface (SCI) model 302, an SCI package 
304, an SCI class 306, and an SCI member 308. The SCI model 302 is the source code 
organized into packages. The SCI model 302 corresponds to a directory for a software 
project being developed by the user, and the SCI package 304 corresponds to a subdirectory. 

20 The software project comprises the source code in at least one file that is compiled to form a 
sequence of instructions to be run by a data processing system. The data processing system 
is discussed in detail below. As is well known in object-oriented programming, the class 
306 is a category of objects which describes a group of objects with similar properties 
(attributes), common behavior (operations or methods), common relationships to other 

25 objects, and common semantics. The members 308 comprise attributes and/or operations. 

For example, the data structure 500 for the source code 400 depicted in Fig. 4 is 
depicted in Fig. 5. Userlnterface 402 is defined as a package 404. Accordingly, 
Userlnterface 402 is contained in SCI package 502. Similarly, Bank 406, which is defined 
as a class 408, is contained in SCI class 504, and Name 410 and Assets 412, which are 

30 defined as attributes (strings 414), are contained in SCI members 506. Since these elements 
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are in the same project, all are linked. The data structure 500 also identifies the language in 
which the source code is written 508, e.g., the Java™ language. 

Fig. 6 depicts a data processing system 600 suitable for practicing methods and 
systems consistent with the present invention. Data processing system 600 comprises a 
5 memory 602, a secondary storage device 604, an I/O device 606, and a processor 608. 
Memory 602 includes the improved software development tool 610. The software 
development tool 610 is used to develop a software project 612, and create the TMM 200 in 
the memory 602. The project 612 is stored in the secondary storage device 604 of the data 
processing system 600. One skilled in the art will recognize that data processing system 600 

10 may contain additional or different components. 

Although aspects of the present invention are described as being stored in memory, 
one skilled in the art will appreciate that these aspects can also be stored on or read from 
other types of computer-readable media, such as secondary storage devices, like hard disks, 
floppy disks or CD-ROM; a carrier wave from a network, such as Internet; or other forms of 

1 5 RAM or ROM either currently known or later developed. 

Fig. 7 illustrates an architectural overview of the improved software development 
tool 610. The tool 610 comprises a core 700, an open application program interface (API) 
702, and modules 704. The core 700 includes a parser 706 and an ICE 208. The parser 706 
converts the source code into the language-neutral representation in the TMM, and the ICE 

20 208 converts the text from the displays into source code. There are three main packages 
composing the API 702: Integrated Development Environment (IDE) 708; Read-Write 
Interface (RWI) 710; and Source Code Interface (SCI) 712. Each package includes 
corresponding subpackages. As is well known in the art, a package is a collection of classes, 
interfaces, attributes, notifications, operations, or behaviors that are treated as a single 

25 module or program unit. 

IDE 708 is the API 702 needed to generate custom outputs based on information 
contained in a model. It is a read-only interface, i.e., the user can extract information from 
the model, but not change the model. IDE 708 provides the functionahty related to the 
model's representation in IDE 708 and interaction with the user. Each package composing 
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the DDE group has a description highlighting the areas of applicability of this concrete 
package. 

RWI 710 enables the user to go deeper into the architecture. Using RWI 710, 
information can be extracted from and written to the models. RWI not only represents 
5 packages, classes and members, but it may also represent different diagrams (class diagrams, 
use case diagrams, sequence diagrams and others), links, notes, use cases, actors, states, etc. 

SCI 712 is at the source code level, and allows the user to work with the source code 
almost independently of the language being used. 

There are a variety of modules 704 in the software development tool 610 of the 
10 present invention. Some of the modules 704 access information to generate graphical and 
code documentation in custom formats, export to different file formats, or develop patterns. 
The software development tool also includes a quality assurance (QA) module which 
monitors the modifications to the source code and calculates various complexity metrics, 
i.e., various measurements of the program's performance or efficiency, to support quality 
15 assurance. The types of metrics calculated by the software development tool include basic 
metrics, cohesion metrics, complexity metrics, coupling metrics, Halstead metrics, 
inheritance metrics, maximum metrics, polymorphism metrics, and ratio metrics. Examples 



of these metrics with their respective definitions are identified in Tables 1-9 below. 



Basic Metrics 


Description 


Lines Of Code 


Counts the number of code lines. 


Number Of Attributes 


Counts the number of attributes. If a class has a high number of 
attributes, it may be appropriate to divide it into subclasses. 


Number Of Classes 


Counts the number of classes. 


Number Of Import 
Statements 


Counts the number of imported packages/classes. This measure 
can highlight excessive importing, and also can be used as a 
measure of coupling. 


Number Of Members 


Counts the number of members, i.e., attributes and operations. If 
a class has a high number of members, it may be appropriate to 
divide it into subclasses. 


Number Of Operations 


Counts the number of operations. If a class has a high number of 
operations, it may be appropriate to divide it into subclasses. 



Table 1 - Basic Metrics 
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Cohesion Metrics 


Description 


Lack Of Cohesion Of 
Methods 1 


Takes each pair of methods in the class and determines the set of 
fields they each access. A low value indicates high coupling 
between methods, which indicates potentially low reusability and 
increased testing because many methods can affect the same 
attributes. 


Lack Of Cohesion Of 
Methods 2 


Counts the percentage of methods that do not access a specific 
attribute averaged over all attributes in the class. A high value of 
cohesion (a low lack of cohesion) implies that the class is well 
designed. 


Lack Of Cohesion Of 
Methods 3 


Measures the dissimilarity of methods in a class by attributes. A 
low value indicates good class subdivision, implying simplicity 
and high reusability. A high lack of cohesion increases 
complexity, thereby increasing the likelihood of errors during the 
development process. 


Table 2 - Cohesion Metrics 


Complexity Metrics 


Description 


Attribute Complexity 


Defined as the sum of each attribute's value in the class. 


Cyclomatic 
Complexity 


Represents the cognitive complexity of the class. It counts the 
number of possible paths through an algorithm by counting the 
number of distinct regions on a fiowgraph, i.e., the number of 'if,' 
'for' and 'while' statements in the operation's body. 


Number Of Remote 
Methods 


Processes all of the methods and constructors, and counts the 
number of different remote methods called. A remote method is 
defined as a method which is not declared in either the class itself 
or its ancestors. 


Response For Class 


Calculated as 'Number of Local Methods' + 'Number of Remote 
Methods.' A class which provides a larger response set is 
considered to be more complex and requires more testing than 
one with a smaller overall design complexity. 


Weighted Methods Per 
Class 1 


The sum of the complexity of all methods for a class, where each 
method is weighted by its cyclomatic complexity. The number of 
methods and the complexity of the methods involved is a 
predictor of how much time and effort is required to develop and 
maintain the class. 


Weighted Methods Per 
Class 2 


Measures the complexity of a class, assuming that a class with 
more methods than another is more complex, and that a method 
with more parameters than another is also likely to be more 
complex. 



Table 3 - Complexity Metrics 



Coupling Metrics 


Description 


Coupling Between 
Objects 


Represents the number of other classes to which a class is 
coupled. Counts the number of reference types that are used in 
attribute declarations, formal parameters, return types, throws 
declarations and local variables, and types from which attribute 
and method selections are made. 

Excessive coupling between objects is detrimental to modular 
design and prevents reuse. The more independent a class is, the 
easier it is to reuse it in another application. In order to improve 
modularity and promote encapsulation, inter-object class couples 
should be kept to a minimum. The larger the number of couples, 
the higher the sensitivity to changes in other parts of the design, 
and therefore maintenance is more difficult. A measure of 
coupling is useful to determine how complex the testing of 
various parts of a design is likely to be. The higher the inter- 
object class coupling, the more rigorous the testing needs to be. 


Data Abstraction 
Coupling 


Counts the number of reference types used in the attribute 
declarations. 


FanOut 


Counts the number of reference types that are used in attribute 
declarations, formal parameters, return types, throws declarations 
and local variables. 



Table 4 - Coupling Metrics 



14150897W-4 

- 19- 



Halstead Metrics 


Description 


Halstead Difficulty 


This measure is one of the Halstead Software Science metrics. It 
is calculated as ('Number of Unique Operators' / 'Number of 
Unique Operands') * ('Number of Operands' / 'Number of 
Unique Operands'). 


Halstead Effort 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Halstead Difficulty' * 'Halstead Program 
Volume.' 


Halstead Program 
Length 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Number of Operators' + 'Number of Operands.' 


Halstead Program 
Vocabulary 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Number of Unique Operators' + 'Number of 
Unique Operands.' 


Halstead Program 
Volume 


This measure is one of the Halstead Software Science metrics. It 
is calculated as 'Halstead Program Length' * Log2('Halstead 
Program Vocabulary'). 


Number Of Operands 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of operands used in a class. 


Number Of Operators 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of operators used in a class. 


Number Of Unique 
Operands 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of unique operands used in a class. 


Number Of Unique 
Operators 


This measure is used as an input to the Halstead Software Science 
metrics. It counts the number of unique operators used in a class. 


Table 5 - Halstead Metrics 


Inheritance Metrics 


Description 


Depth Of Inheritance 
Hierarchy 


Counts how far down the inheritance hierarchy a class or 
interface is declared. High values imply that a class is quite 
specialized. 


Number Of Child 
Classes 


Counts the number of classes which inherit from a particular 
class, i.e., the number of classes in the inheritance tree down from 
a class. Non-zero value indicates that the particular class is being 
re-used. The abstraction of the class may be poor if there are too 
many child classes. It should also be stated that a high value of 
this measure points to the definite amount of testing required for 
each child class. 



Table 6 - Inheritance Metrics 
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Maximum Metrics 


Description 


Maximum Number Of 
Levels 


Counts the maximum depth of 'if,' 'for' and 'while' branches in 
the bodies of methods. Logical units with a large number of 
nested levels may need implementation simplification and 
process improvement because groups that contain more than 
seven pieces of information are increasingly harder for people to 
understand in problem solving. 


Maximum Number Of 
Parameters 


Displays the maximum number of parameters among all class 
operations. Methods with many parameters tend to be more 
specialized and, thus, are less likely to be reusable. 


Maximum Size Of 
Operation 


Counts the maximum size of the operations for a class. Method 
size is determined in terms of cyclomatic complexity, i.e., the 
number of 'if,' 'for' and 'while' statements in the operation's 
body. 


Table 7 - Maximum Metrics 


Polymorphism 
Metrics 


Description 


Number Of Added 
Methods 


Counts the number of operations added by a class. A large value 
of this measure indicates that the functionality of the given class 
becomes increasingly distinct from that of the parent classes. In 
this case, it should be considered whether this class genuinely 
should be inheriting from the parent, or if it could be broken 
down into several smaller classes. 


Number Of 
Overridden Methods 


Counts the number of inherited operations which a class 
overrides. Classes without parents are not processed. High 
values tend to indicate design problems, i.e., subclasses should 
generally add to and extend the functionality of the parent classes 
rather than overriding them. 



Table 8 - Polymorphism Metrics 
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Ratio Metrics 


Description 


Comment Ratio 


Counts the ratio of comments to total lines of code including 
comments. 


Percentage Of Package 
Members 


Counts the percentage of package members in a class. 


Percentage Of Private 
Members 


Counts the percentage of private members in a class. 


Percentage Of 
Protected Members 


Counts the percentage of protected members in a class. 


Percentage Of Public 
Members 


Counts the proportion of vulnerable members in a class. A large 
proportion of such members means that the class has high 
potential to be affected by external classes and means that 
increased efforts will be needed to test such a class thoroughly. 


True Comment Ratio 


Counts the ratio of comments to total lines of code excluding 
comments. 



Table 9 - Ratio Metrics 



The QA module also provides audits, i.e., the module checks for conformance to 
predefined or user-defined styles. The types of audits provided by the module include 
coding style, critical errors, declaration style, documentation, naming style, performance, 
possible errors and superfluous content. Examples of these audits with their respective 
definitions are identified in Tables 10-17 below. 
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Coding Style Audits 


Description 


Access Of Static 
Members Through 
Objects 


Static members should be referenced through class names rather 
than through objects. 


Assignment To Formal 
Parameters 


Formal parameters should not be assigned. 


Complex Assignment 


Checks for the occurrence of multiple assignments and 
assignments to variables within the same expression. Complex 
assignments should be avoided since they decrease program 
readability. 


Don't Use the 
Negation Operator 
Frequently 


The negation operator slows down the readability of the program. 
Thus, it is recommended that it not be used frequently. 


Operator '?:' May Not 
Be Used 


The operator '?:' makes the code harder to read than the 
alternative form with an if-statement. 


Provide Incremental In 
For-Statement or use 
while-statement 


Checks if the third argument of the 'for' -statement is missing. 


Replacement For 
Demand Imports 


Demand import-declarations must be replaced by a list of single 
import-declarations that are actually imported into the 
compilation unit. In other words, import-statements may not end 
with an asterisk. 


Use Abbreviated 
Assignment Operator 


Use the abbreviated assignment operator in order to write 
programs more rapidly. Also some compilers run faster with the 
abbreviated assignment operator. 


Use 'this' Explicitly 
To Access Class 
Members 


Tries to make the developer use 'this' explicitly when trying to 
access class members. Using the same class member names with 
parameter names often makes what the developer is referring to 
unclear. 



Table 10 - Coding Style Audits 
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Critical Errors 
Audits 


Description 


Avoid Hiding 
Inherited Attributes 


Detects when attributes declared in child classes hide inherited 
attributes. 


Avoid Hiding 
Inherited Static 
Methods 


Detects when inherited static operations are hidden by child 
classes. 


Command Query 
Separation 


Prevents methods that return a value from a modifying state. The 
methods used to query the state of an object must be different 
from the methods used to perform commands (change the state of 
the object). 


Hiding Of Names 


Declarations of names should not hide other declarations of the 
same name. 


Inaccessible 
Constructor Or 
Method Matches 


Overload resolution only considers constructors and methods that 
are visible at the point of the call. If, however, all the 
constructors and methods were considered, there may be more 
matches. This rule is violated in this case. 

Imagine that ClassB is in a different package than ClassA. Then 
the allocation of ClassB violates this rule since the second 
constructor is not visible at the point of the allocation, but it still 
matches the allocation (based on signature). Also the call to open 
in ClassB violates this rule since the second and the third 
declarations of open are not visible at the point of the call, but it 
still matches the call (based on signature). 


Multiple Visible 
Declarations With 
Same Name 


Multiple declarations with the same name must not be 
simultaneously visible except for overloaded methods. 


Overriding a Non- 
Abstract Method With 
an Abstract Method 


Checks for abstract methods overriding non-abstract methods in a 
subclass. 


Overriding a Private 
Method 


A subclass should not contain a method with the same name and 
signature as in a superclass if these methods are declared to be 
private. 


Overloading Within a 
Subclass 


A superclass method may not be overloaded within a subclass 
unless all overloading in the superclass are also overridden in the 
subclass. It is very unusual for a subclass to be overloading 
methods in its superclass without also overriding the methods it is 
overloading. More frequently this happens due to inconsistent 
changes between the superclass and subclass — i.e., the intention 
of the user is to override the method in the superclass, but due to 
the error, the subclass method ends up overloading the superclass 
method. 


Use of Static Attribute 
for Initialization 


Non- final static attributes should not be used in initializations of 
attributes. 
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Table 1 1 - Critical Errors Audits 



Declaration Style 
Audits 


Description 


Badly Located Array 
Declarators 


Array declarators must be placed next to the type descriptor of 
their component type. 


Constant Private 
Attributes Must Be 
Final 


Private attributes that never get their values changed must be 
declared final. By explicitly declaring them in such a way, a 
reader of the source code get some information of how the 
attribute is supposed to be used. 


Constant Variables 
Must Be Final 


Local variables that never get their values changed must be 
declared final. By explicitly declaring them in such a way, a 
reader of the source code obtains information about how the 
variable is supposed to be used. 


Declare Variables In 
One Statement Each 


Several variables (attributes and local variables) should not be 
declared in the same statement. 


Instantiated Classes 
Should Be Final 


This rule recommends making all instantiated classes final. It 
checks classes which are present in the object model. Classes 
from search/classpath are ignored. 


List All Public And 
Package Members 
First 


Enforces a standard to improve readability. Methods/data in your 
class should be ordered properly. 


Order Of Appearance 
Of Modifiers 


Checks for correct ordering of modifiers. For classes, this 
includes visibility (public, protected or private), abstract, static, 
final. For attributes, this includes visibility (public, protected or 
private), static, final, transient, volatile. For operations, this 
includes visibility (public, protected or private), abstract, static, 
final, synchronized, native. 


Put the Main Function 
Last 


Tries to make the program comply with various coding standards 
regarding the form of the class definitions. 


Table 12 - Declaration Style Audits 


Documentation 
Audits 


Description 


Bad Tag In JavaDoc 
Comments 


This rule verifies code against accidental use of improper 
JavaDoc tags. 


Distinguish Between 
JavaDoc And Ordinary 
Comments 


Checks whether the JavaDoc comments in your program ends 
with '**/' and ordinary C-style ones with '*/.' 



Table 13 - Documentation Audits 
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Naming Style Audits 


Description 


Class Name Must 
Match Its File Name 


Checks whether top level classes or interfaces have the same 
name as the file in which they reside. 


Group Operations 
With Same Name 
Together 


Enforces standard to improve readability. 


Naming Conventions 


Takes a regular expression and item name and reports all 
occurrences where the pattern does not match the declaration. 


Names Of Exception 
Classes 


Names of classes which inherit from Exception should end with 
Exception. 


Use Conventional 
Variable Names 


One-character local variable or parameter names should be 
avoided, except for temporary and looping variables, or where a 
variable holds an undistinguished value of a type. 


Table 14 - Naming Style Audits 


Performance Audits 


Description 


Avoid Declaring 
Variables Inside Loops 


This rule recommends declaring local variables outside the loops 
since declaring variables inside the loop is less efficient. 


Append To String 
Within a Loop 


Performance enhancements can be obtained by replacing String 
operations with StringBuffer operations if a String object is 
appended within a loop. 


Complex Loop 
Expressions 


Avoid using complex expressions as repeat conditions within 
loops. 



Table 15 - Performance Audits 
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Possible Error Audits 


Description 


Avoid Public And 
Package Attributes 


Declare the attributes either private or protected, and provide 
operations to access or change them. 


Avoid Statements 
With Empty Body 


Avoid statements with empty body. 


Assignment To For- 
Loop Variables 


'For' -loop variables should not be assigned. 


Don't Compare 
Floating Point Types 


Avoid testing for equality of floating point numbers since 
floating-point numbers that should be equal are not always equal 
due to rounding problems. 


Enclosing Body 
Within a Block 


The statement of a loop must always be a block. The 'then' and 
'else' parts of 'if -statements must always be blocks. This makes 
it easier to add statements without accidentally introducing bugs 
in case the developer forgets to add braces. 


Explicitly Initialize All 
Variables 


Explicitly initialize all variables. The only reason not to initialize 
a variable is where it' s declared is if the initial value depends on 
some computation occurring first. 


Method finalize() 
Doesn't Call 
super.finalize() 


Calling of super.finalize() from finalize() is good practice of 
programming, even if the base class doesn't define the finalize() 
method. This makes class implementations less dependent on 
each other. 


Mixing Logical 
Operators Without 
Parentheses 


An expression containing multiple logical operators should be 
parenthesized properly. 


No Assignments In 

Conditional 

Expressions 


Use of assignment within conditions makes the source code hard 
to understand. 


Use 'equals' Instead 
Of '==' 


The '=' operator used on strings checks if two string objects are 
two identical objects. In most situations, however, one likes to 
simply check if two strings have the same value. In these cases, 
the 'equals' method should be used. 


Use 'L' Instead Of T 
at the end of integer 
constant 


It is better to use uppercase 'L' to distinguish the letter '1' from 
the number '1.' 


Use Of the 

'synchronized' 

Modifier 


The 'synchronized' modifier on methods can sometimes cause 
confusion during maintenance as well as during debugging. This 
rule therefore recommends against using this modifier, and 
instead recommends using 'synchronized' statements as 
replacements. 



Table 16 - Possible Error Audits 
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Superfluous Content 
Audits 


Description 


Duplicate Import 
Declarations 


There should be at most one import declaration that imports a 
particular class/package. 


Don't Import the 
Package the Source 
File Belongs To 


No classes or interfaces need to be imported from the package to 
which the source code file belongs. Everything in that package is 
available without explicit import statements. 


Explicit Import Of the 
java.lang Classes 


Explicit import of classes from the package 'java.lang' should not 
be performed. 


Equality Operations 
On Boolean 
Arguments 


Avoid performing equality operations on Boolean operands. 
'True' and 'false' literals should not be used in conditional 
clauses. 


Imported Items Must 
Be Used 


It is not legal to import a class or an interface and never use it. 
This rule checks classes and interfaces that are explicitly 
imported with their names - that is not with import of a complete 
package, using an asterisk. If unused class and interface imports 
are omitted, the amount of meaningless source code is reduced - 
thus the amount of code to be understood by a reader is 
minimized. 


Unnecessary Casts 


Checks for the use of type casts that are not necessary. 


Unnecessary 
'instanceof 
Evaluations 


Verifies that the runtime type of the left-hand side expression is 
the same as the one specified on the right-hand side. 


Unused Local 
Variables And Formal 
Parameters 


Local variables and formal parameter declarations must be used. 


Use Of Obsolete 
Interface Modifier 


The modifier 'abstract' is considered obsolete and should not be 
used. 


Use Of Unnecessary 
Interface Member 
Modifiers 


All interface operations are implicitly public and abstract. All 
interface attributes are implicitly public, final and static. 


Unused Private Class 
Member 


An unused class member might indicate a logical flaw in the 
program. The class declaration has to be reconsidered in order to 
determine the need of the unused member(s). 



Table 17 - Superfluous Content Audits 



If the QA module determines that the source code does not conform, an error 
message is provided to the developer. For example, as depicted in Fig. 8A, the software 
development tool checks for a variety of coding styles 800. If the software development 
tool were to check for "Access Of Static Members Through Objects" 802, it would verify 
whether static members are referenced through class names rather than through objects 804. 
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Further, as depicted in Fig. 8B, if the software development tool were to check for 
"Complex Assignment" 806, the software development tool would check for the occurrence 
of multiple assignments and assignments to variables within the same expression to avoid 
complex assignments since these decrease program readability 808. An example of source 
5 code having a complex assignment 810 and source code having a non-complex assignment 
812 are depicted in Figs. 8B and 8C, respectively. The QA module of the software 
development tool scans the source code for other syntax errors and/or other deviations from 
well known rules, as described above, and provides an error message if any such errors are 
detected. 

10 The improved software development tool of the present invention is used to develop 

source code in a project. The project comprises a plurality of files and the source code of a 
chosen one of the plurality of files is written in a given language. The software development 
tool determines the language of the source code of the chosen file, converts the source code 
from the language into a language-neutral representation, uses the language-neutral 

15 representation to textually display the source code of the chosen file in the language, and 
uses the language-neutral representation to display a graphical representation of at least a 
portion of the project. As discussed above, in an alternative embodiment, the textual display 
may be obtained directly from the source code file. The source code and the graphical 
representation are displayed simultaneously. 

20 The improved software development tool of the present invention is also used to 

develop source code. The software development tool receives an indication of a selected 
language for the source code, creates a file to store the source code in the selected language, 
converts the source code from the selected language into a language-neutral representation, 
uses the language-neutral representation to display the source code of the file, and uses the 

25 language-neutral representation to display a graphical representation of the file. Again, the 
source code and the graphical representation are displayed simultaneously. 

Moreover, if the source code in the file is modified, the modified source code and a 
graphical representation of at least a portion of the modified source code are displayed 
simultaneously. The QA module of the software development tool provides an error 

30 message if the modification does not conform to predefined or user-defined styles, as 
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described above. The modification to the source code may be received by the software 
development tool via the programmer editing the source code in the textual pane or the 
graphical pane, or via some other independent software tool that the programmer uses to 
modify the code. The graphical representation of the project may be in Unified Modeling 
5 Language; however, one skilled in the art will recognize that other graphical representations 
of the source code may be displayed. Further, although the present invention is described 
and shown using the various views of the UML, one of ordinary skill in the art will 
recognize that other views may be displayed. 

Fig. 9 depicts a flow diagram of the steps performed by the software development 

10 tool to develop a project in accordance with methods consistent with the present invention. 
As previously stated, the project comprises a plurality of files. The developer either uses the 
software development tool to open a file that contains existing source code, or to create a file 
in which the source code will be developed. If the software development tool is used to 
open the file, determined in step 900, the software development tool initially determines the 

1 5 programming language in which the code is written (step 902). The language is identified 
by the extension of the file, e.g., "Java" identifies source code written in the Java™ 
language, while "xpp" identifies source code written in C++. The software development 
tool then obtains a template for the current programming language, i.e., a collection of 
generalized definitions for the particular language that can be used to build the data structure 

20 (step 904). For example, the templates used to define a new Java™ class contains a default 
name, e.g., "Classl," and the default code, "public class Classl {}." Such templates are 
well known in the art. For example, the "Microsoft Foundation Class Library" and the 
"Microsoft Word Template For Business Use Case Modeling" are examples of standard 
template libraries from which programmers can choose individual template classes. The 

25 software development tool uses the template to parse the source code (step 906), and create 
the data structure (step 908). After creating the data structure or if there is no existing code, 
the software development tool awaits an event, i.e., a modification or addition to the source 
code by the developer (step 910). If an event is received and the event is to close the file 
(step 912), the file is saved (step 914) and closed (step 916). Otherwise, the software 

30 development tool performs the event (step 918), i.e., the tool makes the modification. The 
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software development tool then updates the TMM or model (step 920), as discussed in detail 
below, and updates both the graphical and the textual views (step 922). 

Figs. 10A and 10B depict a flow diagram illustrating the update model step of Fig. 9. 
The software development tool selects a file from the project (step 1000), and determines 
5 whether the file is new (step 1002), whether the file has been updated (step 1004), or 
whether the file has been deleted (step 1006). If the file is new, the software development 
tool adds the additional symbols from the file to the TMM (step 1008). To add the symbol 
to the TMM, the software development tool uses the template to parse the symbol to the 
TMM. If the file has been updated, the software development tool updates the symbols in 

10 the TMM (step 1010). Similar to the addition of a symbol to the TMM, the software 
development tool uses the template to parse the symbol to the TMM. If the file has been 
deleted, the software development tool deletes the symbols in the TMM (step 1012). The 
software development tool continues this analysis for all files in the project. After all files 
are analyzed (step 1014), any obsolete symbols in the TMM (step 1016) are deleted (step 

15 1018). 

Fig. 1 1 depicts a flow diagram illustrating the performance of an event, specifically 
the creation of a class, in accordance with methods consistent with the present invention. 
After identifying the programming language (step 1100), the software development tool 
obtains a template for the language (step 1102), creates a source code file in the project 

20 directory (step 1 104), and pastes the template into the file (step 1 106). The project directory 
corresponds to the SCI model 302 of Fig. 3. Additional events which a developer may 
perform using the software development tool include the creation, modification or deletion 
of packages, projects, attributes, interfaces, links, operations, and the closing of a file. 

Applications to be developed using the software development tool are collectively 

25 broken into three views of the application: the static view, the dynamic view, and the 
functional view. The static view is modeled using the use-case and class diagrams. A use 
case diagram 1200, depicted in Fig. 12, shows the relationship among actors 1202 and use 
cases 1204 within the system 1206. A class diagram 1300, depicted in Fig. 13 with its 
associated source code 1302, on the other hand, includes classes 1304, interfaces, packages 

30 and their relationships connected as a graph to each other and to their contents. 
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The dynamic view is modeled using the sequence, collaboration and statechart 
diagrams. As depicted in Fig. 14, a sequence diagram 1400 represents an interaction, which 
is a set of messages 1402 exchanged among objects 1404 within a collaboration to effect a 
desired operation or result. In a sequence diagram 1400, the vertical dimension represents 
time and the horizontal dimension represents different objects. A collaboration diagram 
1500, depicted in Fig. 15, is also an interaction with messages 1502 exchanged among 
objects 1504, but it is also a collaboration, which is a set of objects 1504 related in a 
particular context. Contrary to sequence diagrams 1400 (Fig. 14), which emphasize the time 
ordering of messages along the vertical axis, collaboration diagrams 1500 (Fig. 15) 
emphasize the structural organization of objects. 

A statechart diagram 1600 is depicted in Fig. 16. The statechart diagram 1600 
includes the sequences of states 1602 that an object or interaction goes through during its 
life in response to stimuli, together with its responses and actions. It uses a graphic notation 
that shows states of an object, the events that cause a transition from one state to another, 
and the actions that result from the transition. 

The functional view can be represented by activity diagrams 1700 and more 
traditional descriptive narratives such as pseudocode and minispecifications. An activity 
diagram 1700 is depicted in Fig. 17, and is a special case of a state diagram where most, if 
not all, of the states are action states 1702 and where most, if not all, of the transitions are 
triggered by completion of the actions in the source states. Activity diagrams 1700 are used 
in situations where all or most of the events represent the completion of internally generated 
actions. 

There is also a fourth view mingled with the static view called the architectural view. 
This view is modeled using package, component and deployment diagrams. Package 
diagrams show packages of classes and the dependencies among them. Component 
diagrams 1800, depicted in Fig. 18, are graphical representations of a system or its 
component parts. Component diagrams 1800 show the dependencies among software 
components, including source code components, binary code components and executable 
components. As depicted in Fig. 19, deployment diagrams 1900 are used to show the 
distribution strategy for a distributed object system. Deployment diagrams 1900 show the 
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configuration of run-time processing elements and the software components, processes and 
objects that live on them. 

Although discussed in terms of class diagrams, one skilled in the art will recognize 
that the software development tool of the present invention may support these and other 
graphical views. 

Adding or Modifying a Link Between Two Elements, and Nesting Two Elements 

In addition to the functionality described above, the software development tool saves 
significant programming development time by allowing a programmer to manipulate a 
diagram so as to form a link (e.g., generalization or implementation link) between two 
elements, and to automatically generate the source code to reflect the link. An element may 
be a class, or an interface. As known to one skilled in the art, a generalization link 
corresponds to an inheritance relationship between the source and destination of the link, 
where the link source inherits all the attributes and methods of the link destination. An 
implementation link corresponds to a specification relationship between the source and the 
destination elements, where the link source implements all the methods contained in an 
interface of the link destination. When a link is already formed, the software development 
tool saves programming time by allowing a programmer to manipulate a graphical 
representation of the link on a diagram so as to form a new link between one of the two 
linked elements and a selected different element, and to automatically generate the source 
code to reflect the new link. Finally, the software development tool frees a programmer 
from typing code by allowing the programmer to manipulate a diagram to nest the source 
code of one element within the source code of another element. In addition, when creating a 
link, removing a link in lieu of a new link, or nesting one element within another element, 
the software development tool enforces object-oriented programming rules, thus assisting a 
programmer in producing error free code. Exemplary object-oriented programming rules for 
inheritance or implementation links are described in Stephen Gilbert & Bill McCarthy, 
Object-Oriented Design In Java . Waite Group Press (1998), which is incorporated herein by 
reference. 
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As shown in Fig. 20, the source and the destination element may be any object- 
oriented component that the software development tool 610 may display in graphical pane 
2008 or textual pane 2010 to model a project and which a programmer can select via a 
mouse click, a predefined keyboard input, or by using some other known input device. For 
5 example, the source and destination element may be selected from among a package 
(graphically depicted as package diagram 2002), a class (graphically depicted as a class 
diagram 2004), or an interface (graphically depicted as an interface diagram 2006). The 
software development tool, however, enforces known object-oriented programming rules 
that dictate that only a class or an interface may have a generalization link or an 

10 implementation link. In addition, class 2004 and interface 2006 have associated source code 
stored in a respective file, but package 2002 does not. As shown in Fig. 20, although 
package 2002 can be displayed in graphical form 2008, package 2002 does not have 
associated source code to be displayed in textual form 2010. The package 2002 identifies a 
directory 2012 of a project 2014 that contains related classes and interfaces that can be used 

15 by an unrelated class when the unrelated class imports the package 2002 into a source code 
file associated with the unrelated class. 

Fig. 21 depicts a flow diagram illustrating an exemplary process performed by the 
software development tool to add a link in source code of a source element, when it is 
determined that the source element is capable of being linked to a destination element. To 

20 add a link, such as a generalization link or an implementation link, in the source code of the 
source element, the software development tool receives an indication or request from a user 
or a programmer to generate a link between a source element and a destination element (step 
2102). In one implementation, the software development tool may receive the indication to 
generate a link based on the actuation of a button 2032 on an exemplary user interface 2000. 

25 One skilled in the art will appreciate that any known programming technique for inputting 
data may be used to convey the same information to the software development tool. 

The software development tool receives an indication identifying the source element 
(step 2104). The software development tool also received an indication identifying the 
destination element (step 2106). The software development tool may receive the indication 

30 identifying the source element via a programmer using any known data input technique 
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associated with I/O device 606, such as a mouse click while the cursor is over a first 
diagram (e.g., class 2004) associated with the source element. The software development 
tool may receive the indication identifying the destination element in a similar manner. 
Note that for each package 2012, 2016, 2018, 2020, and 2022 in the project 2014, the 
5 software development tool stores in a respective graphical view file 2024, 2026, 2028, and 
2030 (file for 2022 is not shown) the name and display coordinates of each symbol, such as 
a class 2004 or a link to a class (not shown), that is displayed in the graphical pane 2008. 
When the project is opened, the software development tool reads the graphical view file into 
the TMM 200 which correlates the names and display coordinates of each symbol of the 

10 respective source code file in the project as discussed in reference to Figs. 10A and 10B, 
above. Thus, the software development tool may invoke the TMM 200 to identify the 
source element and the destination element based on display coordinates received in 
conjunction with the first selection and the second selection, respectively. 

Fig. 22 depicts an exemplary user interface 2200 displayed by the software 

1 5 development tool in response to receiving an indication identifying the source element as a 
package 2202 and an indication identifying the destination element as a class 2204. The 
software development tool displays a graphical reference line 2206 to visually identify the 
source and destination elements that have been selected for a link. 

In one embodiment, the software development tool allows the user to split the textual 

20 pane 2010 into two windows to separately display source code associated with a source 
element and source code associated with a destination element. In this implementation, the 
user may select one of two windows as the first selection using I/O device 606. The 
software development tool then automatically determines that the source code displayed in 
the unselected window is the second selection. 

25 Next, the software development tool determines whether the source element can 

have a link to the destination element (step 2108). This process is described in greater detail 
below. If the source element cannot have a link to the destination element, the software 
development tool displays a link error (step 2110). The exemplary screen 2300 of Fig. 23 
shows that link error 2302 is displayed by the software development tool in response to the 

30 request to link package 2202 to class 2204. The rule enforced here by the development tool 
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is discussed below. As illustrated in Fig. 24, if the source element 2410 can have a link 
2408 to the destination element 2410, the software development tool adds new code 2402 to 
the source code associated with the source element to reflect the link (e.g., a generalization 
link or an implementation link) with the destination element (step 2112). The new code 
5 2402 includes a keyword 2404 and a link destination name 2406. In the example shown in 
Fig. 24, the keyword 2404 is "implements" which corresponds to a known Java™ 
programming language construct for an implementation link. As illustrated in reference to 
Fig. 26 and Fig. 27, the keyword 2604, 2704 that corresponds to a generalization or 
inheritance link is "extends." The link destination name 2406 is the name of the destination 

10 element, which is "ProductPricelnterface" in the example depicted in Fig. 24. 

The software development tool also modifies the graphical representation of the 
source code of the source element to reflect the link from the source to the destination 
element (step 2114). For example, in Fig. 24, a dashed lined arrow 2408 reflects an 
implementation link from the source element (class 2410) to the destination element 

15 (interface 2412), and Fig. 26 and Fig. 27, a solid lined arrow (2608, 2708) reflects the an 
inheritance link from the source element (interface 2610, class 2710) to the destination 
element (interface 2612, class 2712). 

Fig. 25 depicts a flow diagram illustrating the process performed by the software 
development tool in step 2108 of Fig. 20 for determining whether the source element can 

20 have a link to the destination element. Having received the indications of the source and 
destination elements, respectively, the software development tool determines whether the 
source element is a class (step 2502) or, if not, an interface (step 2504). If the source 
element is any other object-oriented component, such as a package, the software 
development tool identifies a link error (step 2506). Because the software development tool 

25 enforces object-oriented programming rules, the software development tool recognizes that a 
class or an interface can have source code reflecting a link to another class or interface, and 
thus indicates a link error when this rule would be violated. In accordance with the 
functions previously described, upon receiving the indication of the source element, the 
software development tool parses the source code for the source element into a respective 

30 data structure 300 of TMM 200, which stores a language-neutral representation of the source 
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code for the source element. Similarly, upon receiving the second selection, the software 
development tool parses the source code for the destination element into a respective data 
structure 300 of TMM 200. In an exemplary embodiment, if the source element or the 
destination element had been selected prior to initiating the process depicted in Fig. 20, then 
5 TMM 200 already contains a language-neutral representation of the source code for the 
respective element. Thus, the software development tool may invoke the TMM 200 to 
ascertain whether the source element is a class or an interface. 

If the source element is an interface (step 2504), the software development tool 
determines whether the destination element is also an interface (step 2508). The software 

10 development tool identifies a link error if the destination element is not an interface (step 
2510) because object-oriented programming rules only allow an interface to have a link to 
another interface. Alternatively, if the destination element is an interface, the software 
development tool identifies the link as an "inheritance" link (step 2512) because object- 
oriented programming rules allow an interface to inherit all method signatures associated 

15 with another interface, but not implement them. As shown in Fig. 26, after identifying the 
source and destination elements as interfaces (2610 and 2612, respectively), the software 
development tool generates new code 2602 that includes the keyword 2604 "extends" and 
the link destination name 2606 of "ProductPricelnterface," corresponding to the name of the 
destination element or interface 2612. 

20 If the source element is a class (step 2502) the software development tool determines 

whether the destination element is a class (step 2514). If the destination element is not a 
class, the software development tool determines whether the destination is an interface (step 
2516). If the destination element is a class, the software development tool identifies the link 
as an "inheritance" link (step 2518) because object-oriented programming rules allow a class 

25 to inherit all attributes and methods defined by another class. As shown in Fig. 27, after 
identifying the source element as class 2710 and the destination element as class 2712, the 
software development tool generates new code 2702 that includes the keyword 2704 
"extends" and the link destination name 2706 "ProductPrice," corresponding to the name of 
the destination element or class 2712. 
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If the destination element is an interface (step 2516), the software development tool 
identifies the link as an "implementation" link (step 2520) because object- oriented 
programming rules allow a class to implement all method signatures specified by an 
interface. As shown in Fig. 28, after identifying the source element as class 2810 and the 
5 destination element as interface 2812, the software development tool generates new code 
2802 that includes the keyword 2804 "implements" and the link destination name 2806 
"ProductPricelnterface," corresponding to the name of the destination element or interface 
2812. While enforcing object-oriented programming rules that support a class having 
multiple links, the software development tool recognized that the class 2810 already had an 

10 inheritance link reflected by code 2814 and added new code 2802 without disturbing the 
original code 2814. Alternatively, if the destination element is a class (step 2514) or an 
interface (step 2516), the software development tool identifies a link error (step 2522) 
because object-oriented programming rules allow a class to inherit from another class or to 
implement from an interface. 

1 5 The process depicted in Fig. 29 illustrates the replacement of a source element (link 

source) or a destination element (link destination) in an existing link with another element to 
form a new link. The software development tool either replaces an existing link from the 
source element to the destination element with a new link from the source element to the 
other element (new link destination), or replaces an existing link from the source element to 

20 the destination element with a new link from the other element (new link source) to the 
destination element. By performing the process depicted in Fig. 29, the software 
development tool again saves a programmer from manually modifying the source code of 
the source element to reflect the new link with the other element. Moreover, by enforcing 
object-oriented programming rules for a link, the software development tool prevents the 

25 programmer from producing errors that may not be discovered until compilation of the 
source or other element. 

To replace an existing link with a new link, the software development tool receives 
an identification of the existing link between a source element and a destination element 
(step 2902). In one implementation discussed below in reference to Fig. 30, the software 

30 development tool receives the display coordinates for the existing link when a user or 
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programmer clicks on the existing link 3002 displayed on the graphical form 3004. The 
TMM 200 identifies the symbol associated with the received display coordinates and 
provides this information to the software development tool, which correlates and stores the 
display coordinates of the existing link with the associated source code for the source 
5 element (i.e., the link destination). The identification of the existing link includes the link 
source name 3004 and link destination name 3006, corresponding respectively to the source 
element and the destination element in the existing link. The identification of the existing 
link also includes the keyword 3008 that identifies the type of link. As shown in Fig. 30, the 
existing link 3002 has a keyword 3008 of "extend" that identifies the existing link 3002 as a 

10 generalization or inheritance link. To clarify the following discussion, the source element 
and the destination element will be identified by the graphical representation of each 
element, such as 3010 and 3014, respectively. 

The software development tool also receives an identification of a selected element 
from among the source and destination elements (step 2904). As shown in Fig. 31, the 

15 source element 3108 and the destination element 3110 are associated with link 3102. The 
software development tool recognizes that the selected element will be used to form a new 
link. The link 3102 has a first end 3104 associated with the link source (source element) 
3 108 and a second end 3 106 associated with the link destination (destination element) 3 1 10. 
Any known programming technique may be used to select the element that will be used to 

20 form a new link. For example, by clicking on the first end 3104 of the link 3102 and 
dragging away from the link source, the selected element (i.e., the link destination) remains 
linked. Accordingly, as depicted in Fig. 31, the destination element 3110 associated with 
the second end 3106 of the link 3102 remains linked because the first end 3104 is dragged 
away from the source element 3 108. 

25 To replace the link with a new link, the software development tool also receives an 

identification of another element for a new link (step 2906). Again, any known 
programming technique may be used to indicate the other element to the software 
development tool. In the implementation shown in Fig. 31, the software development tool 
receives the indication of the other element (package 31 12) when the first end 3 104 of link 

30 3102 is dragged and dropped over package 3112. The software development tool receives 
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display coordinates from the TMM 200, which correlates the display coordinates to the other 
element as a class, an interface, or other object-oriented component, such as a package (e.g., 
3112), and identifies the other element to the software development tool. 

Next, the software development tool determines whether the selected element to 
keep from the existing link 3102 is the source element (i.e. link source) (step 2908). As 
described in reference to step 2904, the software development tool determines that the 
selected element is the source element 3108 when the second end 3106 is removed or 
dragged from the destination element 3110. Alternatively, the software development tool 
determines that the selected element is the destination element 3110 (link destination) when 
the first end 3104 is removed or dragged from the source element 3108. In addition, the 
TMM 200 identifies whether the selected element (i.e., the source element or the destination 
element) is a class, an interface, or other object-oriented component, such as a package. 

If the selected element is the destination element or link destination, then the 
software development tool determines whether the other element can be linked to the 
destination element (step 2910), as discussed further below. If the other element cannot 
have a link to the destination element, the software development tool displays a link error 
(step 2912). For example, as shown on screen 3200 of Fig. 32, the software development 
tool displays hnk error 3202 after determining that package 3112 cannot have a link to class 
3110 (i.e., 3108 of Fig. 31). If the other element can have a link to the destination element, 
the software development tool removes a portion of the source code associated with the 
source element that reflects the exiting hnk to the destination element (step 2914). In the 
example shown in Fig. 33, the portion of the source code associated with the source element 
3308 that is removed may be "extend ProductPrice" 3012 in Fig. 30. As discussed in 
reference to Fig. 10A and 10B, the software development tool may remove the portion of the 
source code from a file containing the source code associated with the source element 3308 
and then update the TMM 200. The software development tool also modifies the graphical 
representation of the source code of the source element to reflect the removal of the existing 
link (step 2916). As shown in Fig. 33, the software development tool removes the hnk 
3102, in Fig. 31, to reflect the removal of code 3012 from the source element 3108 and 
3308. The software development tool may modify the graphical representation of the source 
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code of the source element based on the language neutral representation of the code in the 
updated TMM 200. 

To generate the new link from the other element to the destination element, the 
software development tool adds new code to the source code associated with the other 
element to reflect the new link with the destination element (step 2918). For example, in 
Fig. 33, the software development tool adds new code 3310 to the source code associated 
with the other element 3304 to generate new link 3302 from the other element 3304 to the 
destination element 3306. The new code 3310 includes a keyword 3312 and a link 
destination name 3314. In the example shown in Fig. 33, the keyword 3312 is "extends" 
which identifies a generalization or inheritance link. The link destination name 3314 is the 
name of the destination element, which is "ProductPrice" in the example depicted in Fig. 33. 
The software development tool then modifies the graphical representation of the source code 
of the other element to reflect the link to the destination element (step 2920). 

If the one element selected from the linked elements (i.e., source or destination 
element) is the source element (link source), then the software development tool determines 
whether the source element can be linked to the other element (step 2922). When it is 
determined that the source element cannot have a link to the other element, the software 
development tool displays a link error as shown on screen 3200 of Fig. 32 (step 2912). As 
illustrated in Fig. 34, when it is determined that the source element 3404 can have a link to 
the other element 3406, the software development tool replaces a portion of the source code 
associated with the source element 3404 that reflects the existing link to the destination 
element 3408 with new code to reflect a new link to the other element 3406 (step 2924). As 
discussed in reference to Figs. 10A and 10B, the software development tool may replace the 
portion of the source code from a file containing the source code associated with the source 
element 3308 and then update the TMM 200. In the example shown in Fig. 34, the portion 
of the source code associated with the source element 3404 that is replaced is "implements 
ProductPricelnterface" 3410. As shown in Fig. 35, the software development tool adds new 
code 3510 to the source code associated with the source element 3504 to reflect the new link 
3502 with the other element 3506. The new code 3510 includes a keyword 3512 and a link 
destination name 3514. In the example shown in Fig. 35, the keyword 3512 is "implements" 
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which identifies an implementation link. The link destination name 3514 is the name of the 
other element, which is "Interface 1" in the example depicted in Fig. 35. The software 
development tool then modifies the graphical representation of the source code of the source 
element to reflect the new link 3502 from the source to the other element (step 2926). 
5 Fig. 36 depicts a flow chart illustrating the process performed by the software 

development tool in step 2910 for determining whether the other element (new link source) 
can have a link to the destination element (link destination). As shown in Fig. 36, the 
software development tool determines whether the other element is a class (step 3602) or, if 
not, an interface based on the received identification of the other element (step 3604). If the 

10 other element is any other object-oriented component, such as package, the software 
development tool identifies a link error (step 3606). 

If the other element is an interface, the software development tool determines 
whether the destination element is also an interface (step 3608). The software development 
tool identifies a link error if the destination element is not an interface (step 3610) because 

15 object-oriented programming rules allow an interface to have a link to another interface, but 
not to a class or a package. Alternatively, if the destination element is an interface, the 
software development tool identifies the new link as an "inheritance" link (step 3612) 
because object-oriented programming rules allow an interface to inherit all method 
signatures associated with another interface, but not to implement them. For example, as 

20 shown in Fig. 37, the software development tool displays user interface 3700 in response to 
receiving an identification that the one element selected from the linked elements is the 
destination element 3710 and to receiving an identification of the other element 3712. In 
Fig. 38, when it is determined that the other element and the destination element are 
interfaces (3804 and 3806, respectively), the software development tool identifies the new 

25 link 3802 as an "inheritance " link. Thus, while performing step 2918, the software 
development tool generates new code 3810 that includes the keyword 3812 "extends" and 
the link destination name 3814, "ProductPricelnterface," corresponding to the name of the 
destination element or interface 3804. While performing step 2920, the software 
development tool modifies the graphical representation of the source code of the other 
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element 3806 to reflect the new link 3802 by displaying the new link 3802 as a solid arrow 
as shown in Fig. 38. 

If the other element is a class (step 3602), the software development tool determines 
whether the destination element is a class (step 3614). If the destination element is a class, 
5 the software development tool identifies the link as an "inheritance" link (step 3618) 
because object-oriented programming rules allow a class to inherit all attributes and methods 
defined by another class. For example, returning to Fig. 31, the software development tool 
displays user interface 3100 in response to receiving an identification that the one element 
selected from the linked elements is the destination element 3110 and to receiving an 

10 identification of the other element 3112. When it is determined that the destination element 
and other elements are classes (3306 and 3304, respectively), the software development tool 
identifies the new link 3302 as an "inheritance " link. Thus, while performing step 2918, the 
software development tool generates new code 3310 that includes a keyword 3312 
"extends" and a link destination name 3314 of "ProductPrice," corresponding to the name of 

15 the destination element or interface 3306. While performing step 2920, the software 
development tool modifies the graphical representation of the source code of the other 
element 3304 to reflect the new link 3302 by displaying the new link 3302 as a solid arrow 
as shown in Fig. 38. 

If the destination element is not a class, the software development tool determines 
20 whether the destination element is an interface (step 3616). If the destination element is an 
interface, the software development tool identifies the link as an "implementation" link (step 
3620) because object-oriented programming rules allow a class to implement all method 
signatures specified by an interface. For example, as shown in Fig. 39, the software 
development tool displays user interface 3900 in response to receiving an identification that 
25 the one element selected from the linked elements is the destination element 3910 and to 
receiving an identification of the other element 3912 in accordance with methods and system 
consistent with the present invention. As illustrated in Fig. 40, when it is determined that 
the other element is a class and the destination element is an interface (4004 and 4006, 
respectively), the software development tool identifies the new link 4002 as an "inheritance 
30 " link. Thus, while performing step 2918, the software development tool generates new 
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code 4010 that includes a keyword 4012 "extends" and a link destination name 4014 of 
"ProductPricelnterface," corresponding to the name of the destination element or interface 
4006. While performing step 2920, the software development tool modifies the graphical 
representation of the source code of the other element 4004 to reflect the new link 4002 by 
5 displaying the new link 4002 as a dashed arrow as shown in Fig. 40. 

Alternatively, when the destination element is determined not to be a class in step 
3614 or an interface in step 3616, the software development tool identifies a link error (step 
3622) because object-oriented programming rules only allow a class to inherit from another 
class or to implement from an interface. 

10 Fig. 41 depicts a flowchart of the steps performed by the software development tool 

in the step 2922 for determining whether the source element (link source) can have a link to 
the other element (new link destination). As shown in Fig. 41, the software development 
tool determines whether the source element is a class (step 4102), or if not, an interface (step 
4104) based on the received identification of one element to keep as the source element. If 

15 the source element is any other object-oriented component, such as a package, the software 
development tool identifies a link error (step 4106) which it may display in step 2912. If the 
source element is an interface in step 4104, the software development tool determines 
whether the other element is also an interface (step 4108). The software development tool 
identifies a link error when the other element is determined not to be an interface (step 4110) 

20 because object-oriented programming rules only allow an interface to have a link to another 
interface, but not to a class or a package. Alternatively, when its determined that the source 
element is an interface, the software development tool identifies the new link as an 
"inheritance" link (step 4112) because object-oriented programming rules allow an interface 
to inherit all method signatures associated with another interface, but not to implement them. 

25 For example, as shown in Fig. 42, the software development tool displays user interface 
4200 in response to receiving an identification that the one element to keep is the source 
element 4204 and to receiving an identification of the other element 4206. When it is 
determined that the source and other elements are interfaces (4304 and 4306, respectively), 
the software development tool identifies the new link 4302 as an "inheritance " link. Thus, 

30 while performing step 2924, the software development tool replaces portion of code 4210 
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with new code 4310 that includes a keyword 4312 "extends" and a link destination name 
4314 of "Interface I," corresponding to the name of the other element or interface 4306. 
While performing step 2926, the software development tool modifies the graphical 
representation of the source code of the source element 4304 to reflect the new link 4302 by 
5 displaying the new link 4302 as a solid arrow as shown in Fig. 43 . 

If the source element is a class in step 4102, the software development tool 
determines whether the other element is a class (step 4114). If the other element is a class, 
the software development tool identifies the link as an "inheritance" link (step 4118) 
because object-oriented programming rules allow a class to inherit all attributes and methods 

10 defined by another class. 

If the other element is not a class, the software development tool determines whether 
the other element is an interface (step 4116). If the source element is an interface, the 
software development tool identifies the link as an "implementation" link (step 4120) 
because object-oriented programming rules allow a class to implement all method signatures 

1 5 specified by an interface. 

Alternatively, when the source element is determined not to be a class in step 4114 
or a interface in step 4116, the software development tool identifies a link error (step 4122) 
because object-oriented programming rules allow a class to inherit from another class, but 
not an interface, or to implement from an interface, but not another class. 

20 To further aid a programmer in developing source code for a software project, the 

software development tool performs the exemplary process depicted in Fig. 44 to move 
source code associated with a source element into source code of a destination element. By 
performing this process the software development tool allows a programmer to nest a first 
object-oriented element, such as a class or interface, within a second object-oriented element 

25 without having to manually open and edit the respective files for each object-oriented 
element as described below. Thus, for example, a programmer can automatically combine a 
first class within a related second class to easily manage and organize software in a project 
and to more easily allow other programmers to access or use the source code associated with 
the combined classes. Similarly, the software development tool performs the exemplary 

30 process, depicted in Fig. 49, to remove source code associated with a source element from 



-45 - 



within a destination element. By performing this process the software development tool 
allows a user or programmer to remove a first object-oriented element, such as a class or 
interface, from a second object-oriented element, where source code associated with the 
source element is nested within source code associated with the destination element. Thus, 
5 for example, a programmer can automatically remove a first class nested within a second 
class to separate unrelated functionality between the first and second classes that has become 
apparent to the programmer during the development of the first and second classes. 

Fig. 44 depicts a flow chart of the process performed by the software development 
tool for moving source code associated with a source element into source code of a 

10 destination element. To move source code in this manner, the software development tool 
receives an identification of the source element (step 4402). The software development tool 
also receives an identification of the destination element (step 4404). In one implementation 
shown in Fig. 45, the software development tool may receive the identification of the source 
element via a programmer selecting a first diagram 4506 associated with the source element 

15 on the graphical form 4502, and may receive the identification of the destination element via 
the programmer dragging the first diagram over a second diagram 4508 associated with the 
destination element. It is also contemplated that the software development tool may receive 
the identification of the source element or the destination element via a programmer 
selecting source code associated with the respective source or destination element when in 

20 view on the textual form 4504. 

The software development tool also receives an indication or request that the source 
element is to be moved within the destination element (step 4406). In one implementation, 
the software development tool receives the indication to move the source element into the 
destination element via a programmer completing the action of dragging and dropping the 

25 first diagram 4506 associated with the source element on the second diagram 4508 
associated with the destination element as shown in Fig. 45. It is also contemplated that the 
software development tool may receive the indication to move the source element into the 
destination element via a programmer actuating a button on the user interface 4500, 
selecting a choice on a pull-down or speed menu (not shown) on the user interface 4500, or 

30 other known programming techniques for receiving inputs. 
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Next, the software development tool determines whether the source and the 
destination elements are either a class or an interface (step 4408). A class and an interface 
are known object-oriented elements that have source code which may be moved into another 
class or interface. As previously discussed, the software development tool may determine 
5 whether an identified element is a class or interface by invoking the TMM 200 to correlate 
the selected or identified diagram (or display coordinates for the identified diagram) to the 
corresponding element in a file in the software project. For example, the software 
development tool determines that the first diagram 4506 corresponds to source code 4514 
for the source element (named "Class3") that is stored in a first file 4510 ("Class3.java") in 
10 the software project. Similarly, the software development tool determines that the second 
diagram 4506 corresponds to source code (not shown in Fig. 45) for the destination element 
(named "SubClassProductPrice") that is stored in a second file 4512 
("SubClassProductPrice.java") in the software project. 

When it is determined that both the source and destination elements are a class or an 
15 interface, the software development tool moves the source code corresponding to the source 
element 4602 within the source code corresponding to the destination element 4604 (step 
4410) as shown in Fig. 46. In performing this step, the software development tool copies the 
source code corresponding to the source element from the first file 4510 and properly inserts 
or nests it into the source code corresponding to the destination element that is contained in 
20 the second file 4512. The software development tool then deletes the first file 4510 as is 
apparent from the user screen 4600 in Fig. 46, displayed by the software development tool 
after performing step 4410. 

The software development tool also modifies the graphical representation of the 
destination element to reflect the movement of the source code corresponding to the source 
25 element into the destination element (step 4412). For example, in Fig. 46, the software 
development tool modifies the second diagram 4606 that graphically represents the source 
code of the destination element to include a notation 4608, "+Class3," to reflect that the 
source code corresponding to the source element is nested within the source code of the 
destination element. As known to those skilled in the art, the notation 4608 may be 
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abbreviated and be positioned on or near the second diagram 4606 to convey the movement 
of the source element 

When it is determined that both the source and destination elements are not a class or 
an interface, the software development tool determines whether the source element is a class 
5 or an interface (step 4414). When it is determined that the source element is a class or an 
interface, the software development tool knows that the destination element is not a class or 
an interface so the software development tool determines whether the destination element is 
a package. When it is determined that the destination element is a package, the software 
development tool moves the first file that includes the source code associated with the 
1 0 source element within a directory associated with the destination element (step 44 1 8). While 
a package does not include source code except to the extent related classes or interfaces are 
included in a directory associated with the package, a package may be used in object- 
oriented programming to import a related class or a related interface into an unrelated class. 
Therefore, the software development tool advantageously aids a programmer to organize 
15 and relate the source element with a selected package by performing the process depicted in 
Fig. 44. For example, assuming the source element identified to be moved in accordance 
with this invention is associated with the first diagram 4606 and the destination element 
identified is associated with the second diagram 4610, the software development tool may 
then display the exemplary user interface 4700 in Fig. 47 based on the determination that the 
20 source element is the class named "SubClassProductPrice" and the destination element is the 
package named "Package2." As shown in Fig. 47, the software development tool moves the 
first file 4702 associated with the source element within the directory 4704 associated with 
the destination element, "Package2." 

In addition, the software development tool also modifies the graphical representation 
25 of the destination element to reflect the movement of the source code corresponding to the 
source element into the destination element (step 4412). For example, as shown in Fig. 47, 
the software development tool modifies the second diagram 4706 that graphically represents 
the destination element, "Package2," to include a notation 4708, "+SubClassProductPrice" 
to reflect that the first file 4702 that includes source code corresponding to the source 
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element is moved within the directory 4704 corresponding to the destination element, 
"Package2." 

When it is determined that the source element is not a class or an interface, the 
software development tool knows that neither the source nor the destination element is a 
5 class or an interface. The software development tool then determines whether the source 
element is a package (step 4420). When it is determined that the source element is a 
package, the software development tool next determines whether the destination element is 
also a package (step 4422). When it is determined that the destination element is a package, 
the software development tool moves a first directory associated with the source element 

10 within a second directory associated with the destination element. For example, assuming 
that first diagram 4606 and second diagram 4610 graphically depict the source and 
destination elements, respectively, the software development tool 110 displays the 
exemplary user interface 4800 in Fig. 48 upon determining that the source and the 
destination elements are packages. As shown in Fig. 48, the software development tool 1 10 

15 moves the first directory 4704 within the second directory 4712. Thus, a programmer can 
diagrammatically move a first package within a second package to allow another 
programmer to access all classes and interfaces contained within both packages by 
importing only the second package. 

Fig. 49 depicts a flow chart illustrating an exemplary process performed by the 

20 software development tool for removing source code associated with a source element from 
within source code of a destination element. To remove source code associated with a 
source element from within a destination element, the software development tool receives an 
identification of a source element within a destination element (step 4902). In one 
implementation, the software development tool may receive the identification of the source 

25 element via a programmer selecting a graphical notation 5006 displayed by the software 
development tool in association with a diagram 5008 that graphically represents the source 
code corresponding to the destination element. The graphical notation 5006 represents the 
source code of the source element that is within the source code of the destination element. 
Therefore, the software development tool receives the identification of both the source 

30 element and the destination element when a programmer selects the graphical notation 5006. 
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It is also contemplated that the software development tool may receive the identification of 
the source element and the destination element via a programmer selecting source code 
associated with the source element within the source code of the destination element when 
in view on the textual form 5004. 

The software development tool also receives an indication or request that the source 
element is to be removed from within the destination element (step 4904). In one 
implementation, the software development tool receives the indication to remove the source 
element from the destination element via a programmer completing the action of dragging 
and dropping the notation 5006 associated with the source element on an unoccupied area 
5010 of the graphical form 5002 as shown in Fig. 50. It is also contemplated that the 
software development tool may receive the indication to move the source element into the 
destination element via a programmer actuating a button on the user interface 5000, 
selecting a choice on a pull-down or speed menu (not shown) on the user interface 5000, or 
other known programming techniques for receiving inputs. 

Next, the software development tool determines whether the source and the 
destination elements are either a class or an interface (step 4906). The software 
development tool may determine whether the destination element is a class or interface by 
invoking the TMM 200 to correlate the selected diagram 5008 (or display coordinates for 
the diagram 5008) to the corresponding source code of the destination element that is 
language neutrally represented in the TMM 200. By identifying the destination element in 
this manner, the software development tool may identify a second file 5012 in the software 
project that includes the source code 5014 of the destination element. Similarly, the 
software development tool may determine whether the destination element is a class or 
interface by invoking the TMM 200 to correlate the graphical notation 5006 displayed in 
association with the selected diagram 5008 to the corresponding source code of the source 
element that resides within the source code of the destination element. For example, the 
software development tool determines that the second diagram 5008 corresponds to source 
code 5014 for the destination element (named "SubClassProductPrice") that is stored in the 
second file 5012 ("SubClassProducfPrice.java") in the software project. Similarly, the 
software development tool determines that the graphical notation 5006 corresponds to 
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source code 5016 for the source element (named "Class3") that is nested within the source 
code 5014 of the destination element. 

When it is determined that both the source and destination elements are a class or an 
interface, the software development tool removes the source code corresponding to the 
5 source element 5016 from within the source code corresponding to the destination element 
5014 (step 4908) as shown in Fig. 50 and Fig. 5 1 . To remove the source code corresponding 
to the source element 5016, the software development tool may open the second file 5012, 
search for the source element, and remove source code corresponding to the source element. 
The software development tool displays the user interface 5100 in Fig. 51 after removal of 

10 the source element from within the destination element. Once the source code for the source 
element is removed, the software development tool stores the source code of the source 
element 5016 within a first file 5102 (step 4909). 

The software development tool also displays a graphical representation of the source 
code corresponding to the source element (step 4910), and modifies the graphical 

15 representation of the destination element to reflect the movement of the source code 
corresponding to the source element (step 4912). For example, the software development 
tool displays the first diagram 5104 to graphically represent the source code of the source 
element, named "Class3." The software development tool modifies the graphical 
representation of the source code of the destination element by redisplaying the second 

20 diagram 5106 without the notation 5006 to reflect that the source code corresponding to the 
source element is not within the source code of the destination element. As part of 
performing step 4910, the software development tool updates the TMM 200 by using parser 
706 to read the first file 5102 and the modified second file 5012 such that the TMM 200 
holds a current language neutral representation of both the source and the destination 

25 elements. 

Returning to Fig. 49, when it is determined that both the source and destination 
elements are not a class or an interface, the software development tool determines whether 
the source element is a class or an interface (step 4914). When it is determined that the 
source element is a class or an interface, the software development tool knows that the 
30 destination element is not a class or an interface. The software development tool then 
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determines whether the destination element is a package (step 4916). It is contemplated that 
step 4916 may not be performed when the source element, identified as a class or an 
interface, would not reside in a repository other than a directory associated with a package. 

If the destination element is a package, the software development tool removes a first 
file that includes the source code associated with the source element from a directory 
associated with the destination element to another directory (step 4918). In one 
implementation depicted in Fig. 53, the software development tool removes the first file 
5206 from a directory 5208 to another directory 5302 based on a programmer completing 
the action of dragging and dropping the notation 5202 associated with the source element on 
an unoccupied area of the graphical form 5210. In this implementation, the other directory 
5302 includes the directory 5208 associated with the destination element ("Package2") and 
the first file 5206. However, it is contemplated that the software development tool may 
remove the first file 5206 to another directory, such as the directory 5310 
("DataManagement" package) based on a programmer dragging and dropping the notation 
5202 on a symbol associated with directory 53 10. Thus, a programmer that finds the source 
element no longer relates to the destination element package can easily move the source 
element from the destination element package to another package to group the source 
element with classes or interfaces that are more related to the source element. 

The software development tool also displays a graphical representation of the source 
code corresponding to the source element (step 4910), and modifies the graphical 
representation of the destination element to reflect the movement of the source code 
corresponding to the source element (step 4912). For example, in Fig. 53 the software 
development tool displays the first diagram 5304 to graphically represent the source code of 
the source element, named "SubClassProducfPrice," stored in the first file 5206. The 
software development tool modifies the graphical representation of the destination element, 
"Package2," by redisplaying the second diagram 5306 without the graphical notation 5202 
to reflect that the first file 5206 is removed from the directory 5208 corresponding to the 
destination element, "Package2." 

As illustrated in Figs. 54 and 55, when it is determined that the source element is not 
a class or an interface, the software development tool knows that neither the source nor the 
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destination element is a class or an interface. The software development tool then 
determines whether the source element is a package (step 4920). When it is determined that 
the source element is a package, the software development tool next determines whether the 
destination element is also a package (step 4922). When it is determined that the destination 
5 element is a package, the software development tool removes a directory associated with the 
source element from within a second directory associated with the destination element to a 
third directory. 

While various embodiments of the present invention have been described, it will be 
apparent to those of ordinary skill in the art that many more embodiments and 
10 implementations are possible that are within the scope of this invention. Accordingly, the 
invention is not to be restricted except in light of the attached claims and their equivalents. 
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